widgets.brease.DropDownBox

Widget Description

short: DropDownliste von Texten
de: Zeigt eine DropDownliste, aus welcher der Benutzer Elemente auswählen kann
en: Displays a drop-down list where the user can select items

Properties

name description category type defaultValue bindable readOnly required localizable editableBinding projectable cssProp (has no setter and getter in JS) groupRefId groupOrder nodeRefId (for linking node and value) deprecated typeRefId (for StyleReference) subtype (for MpComIdentReference)
cropToParent Crop list to parent element Behavior brease.enum.CropToParent none false false false false false true
dataProvider ItemCollection see Datatype Data ItemCollection [] true false false false false true
displaySettings Defines which elements are displayed on the widget Appearance brease.enum.DropDownDisplaySettings default false false false false false true
ellipsis If true, overflow of text is symbolized with an ellipsis. This option has no effect, if wordWrap = true. Behavior Boolean false false false false false false true
enable Initial option to enable widget. Behavior Boolean true true false false false false true
fitHeight2Items If true, the height will fit to the necessary height if the height oft the list is bigger If false, the list uses the configured height Behavior Boolean true false false false false false true
imageAlign Position of images relative to text Appearance brease.enum.ImagePosition left false false false false false true
imagePath Path to the images location (e.g. 'Media/images/'). Names of the images must be given like the index in the dataProvider (e.g. 0.png, 1.png, 2.png) Appearance DirectoryPath false false false false false true
itemHeight Height of every item in the List Appearance Integer 40 false false false false false true
listPosition Position of opened list relative to ToggleButton. Appearance brease.enum.Position right false false false false false true
listWidth Width of list and its items when the widget is pressed. Appearance Integer 150 false false false false false true
maxVisibleEntries An integer to determine max-height of the list Appearance UInteger 4 false false false false false true
multiLine If true, more than one line is possible. Text will wrap when necessary (wordWrap=true) or at line breaks (\n). If false, text will never wrap to the next line. The text continues on the same line. Behavior Boolean false false false false false false true
permissionOperate restricts operability to users, which have given roles Accessibility RoleCollection no defaultValue
defined		 false false false false false true
permissionView restricts visibility to users, which have given roles Accessibility RoleCollection no defaultValue
defined		 false false false false false true
selectedIndex Index of the selected item. The first item has index=0 Data Integer 0 true false false false true true
selectedValue Value of the selected item Data String true false false false true true
style reference to a style for this widget type Appearance StyleReference default true false false false false true
tabIndex sets if a widget should have autofocus enabled (0), the order of the focus (>0), or if autofocus should be disabled (-1) Behavior Integer 0 false false false false false true
tooltip reference to a tooltip for a widget Appearance String false false false true false true
visible change visibility Behavior Boolean true true false false false false true
wordWrap If true, text will wrap when necessary. Behavior Boolean false false false false false false true
maxHeight maximum outer height of widget Size 0 false false false true true
minHeight minimum outer height of widget Size 0 false false false true true
maxWidth maximum outer width of widget Size 0 false false false true true
minWidth minimum outer width of widget Size 0 false false false true true
zIndex The zIndex property specifies the z-order of a widget and its childs.
When widgets overlap, z-order determines which one covers the other. A widget with a larger zIndex generally covers a widget with a lower one.
The zIndex must be unique within a content.
 UInteger no defaultValue
defined		 false false true true true
left absolute position measured from left boundary of parent container Integer no defaultValue
defined		 false false false true true
top absolute position measured from top boundary of parent container Integer no defaultValue
defined		 false false false true true
height outer height of widget Size 30 false false false true true
width outer width of widget Size 100 false false false true true

Styleable Properties

name type description defaultValue
cornerRadius PixelValCollection

Sets the radius of both widget and the drop-down list rounded corners. For further information, please check its type

 0px
opacity Opacity

Opacity of the widget

 1
margin Margin

Margin of the Widget

 0px
shadow Shadow

Shadow of the Widget

 none
backColor Color

Sets the background color of the widget

 #DBDBDB
mouseDownBackColor Color

Sets the background color of the widget when it is clicked and the drop-down list is displayed

 #DBDBDB
disabledBackColor Color

Sets the background color when the widget is disabled

 #F1F1F1
backGroundGradient Gradient

Sets the background color of the items not selected as a gradient
mouseDownBackGroundGradient Gradient

ets the text color of the widget when it is clicked and the drop-down list is displayed
disabledBackGroundGradient Gradient

Background as a gradient
borderStyle BorderStyle

Sets the border style of the widget. For further information, please see its type

 solid
borderWidth PixelValCollection

Sets the width of the border. For further information, please see its type

 2px
mouseDownBorderWidth PixelValCollection

Sets the border with of the widget when it is clicked and the drop-down list is displayed

 2px
borderColor ColorCollection

Sets the border color of both the widget and the drop-down list

 #5B7C70
mouseDownBorderColor ColorCollection

Sets the border color of the widget when it is clicked and the drop-down list is displayed

 #FD7B01
disabledBorderColor ColorCollection

Sets the border color when the widget is disabled

 #FFFFFF #C8C8C8 #C8C8C8 #FFFFFF
textColor Color

Sets the color of the text displayed by the widget

 #000000
mouseDownTextColor Color

Sets the text color of the widget when it is clicked and the drop-down list is displayed

 #000000
disabledTextColor Color

Sets the color of the text when the widget is disabled

 #989898
padding Padding

Padding of the Widget

 0 10px
showOpenIndicator Boolean

If true the indicator image is displayed

 false
openIndicatorColor Color

Color of the image to open the list

 #000000
mouseDownOpenIndicatorColor Color

Color of the image to open the list during mouseDown

 #000000
disabledOpenIndicatorColor Color

Color of the image to open the list when the widget is disabled

 #989898
listPadding Padding

Padding of the list

 0 15px
listBackColor Color

Sets the background color of the drop-down list

 #FFFFFF
listBackGroundGradient Gradient

Background as a gradient
activeBackColor Color

Sets the background color of the selected item

 #ff8800
activeBackGroundGradient Gradient

Sets the background color of the selected item as a gradient
listSeparatorColor Color

Sets the color of the list separator

 #000
listBorderWidth PixelValCollection

Sets the width of the border around the drop-down list. For further information, please check its type

 2px
listTextColor Color

Sets the color of the text of the drop-down list

 #000000
activeTextColor Color

Sets the text color of the selected item

 #ffffff
textAlign brease.enum.TextAlign

Alignment of the text

 center
fontSize PixelVal

Fontsize of the text in pixel

 12px
fontName FontName

Fontname of the text

 Arial
bold Boolean

If true font style is bold

 true
italic Boolean

If true font style is italic

 false

Events

name description arguments
Click Fired when element is clicked on.
  • origin: String

    id of widget that triggered this event

  • horizontalPos: String

    horizontal position of click in pixel i.e '10px'

  • verticalPos: String

    vertical position of click in pixel i.e '10px'

DisabledClick Fired when disabled element is clicked on.
  • origin: String

    id of widget that triggered this event

  • hasPermission: Boolean

    defines if the state is caused due to missing roles of the current user

  • horizontalPos: String

    horizontal position of click in pixel i.e '10px'

  • verticalPos: String

    vertical position of click in pixel i.e '10px'

EnableChanged Fired when operability of the widget changes.
  • value: Boolean

    operability

FocusIn Fired when the widgets gets focus
FocusOut Fired when the widgets lost focus
OnDragEnter Fired when element has onDragEnter.
  • contentId: String

    content id of the widget that has been entering the droppable widget

  • widgetId: String

    id of the widget that has been entering the droppable widget

OnDragLeave Fired when element has OnDragLeave.
  • contentId: String

    content id of the widget that has been leaving the droppable widget

  • widgetId: String

    id of the widget that has been leaving the droppable widget

OnDrop Fired when element has OnDrop.
  • contentId: String

    content id of the widget that has been dropped on the droppable widget

  • widgetId: String

    id of the widget that has been dropped on the droppable widget

SelectedIndexChanged Fired when selectedIndex or selectedValue changes.
  • selectedIndex: Integer

  • selectedValue: String

ToggleStateChanged Triggered when the list is opened or closed.
  • newValue: Boolean

VisibleChanged Fired when the visibility of the widget changes.
  • value: Boolean

    visibility

Actions

name description arguments result
Close Closes the list
Focus Sets focus on the widget element, if it can be focused and keyboardOperation=true
GetSelectedIndex Returns selectedIndex.
GetSelectedValue Returns selectedValue.
Open Opens the list
SetDataProvider method to set the dataProvider
  • value: ItemCollection

    ItemCollection (=Array) of objects of type brease.objects.ListEntry

  • (optional) omitPrompt: Boolean

    (deprecated)

SetEnable Sets the state of property «enable»
  • value: Boolean

SetSelectedIndex Sets the selected entry based on an index
  • index: Integer

  • (optional) omitPrompt: Boolean

    (deprecated)

SetSelectedValue sets the selected entry based on a value
  • value: String

  • (optional) omitPrompt: Boolean

    (deprecated)

SetStyle
  • value: StyleReference

SetVisible Sets the state of property «visible»
  • value: Boolean

ShowTooltip
Toggle Opens or closes the list depending on the actual status